持续集成体系与 BVT

# .github/workflows/ci-pipeline.yml
name: CI Pipeline
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  # 第一层：提交级（目标 < 5 分钟）
  bvt:
    name: "L1: BVT 冒烟"
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.13'
          cache: 'pip'
 
      - name: 安装依赖（利用缓存）
        run: pip install -r requirements.txt
 
      - name: 静态检查
        run: ruff check src/ --exit-zero  # 警告不阻断
 
      - name: BVT 冒烟测试（标记 @smoke 的用例）
        run: |
          pytest tests/ -m "smoke" \
            --tb=short \
            --maxfail=3 \
            -q
 
  # 第二层：PR 级（目标 < 20 分钟）
  unit-integration:
    name: "L2: 单元+集成"
    needs: bvt  # BVT 通过后才执行
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.13'
          cache: 'pip'
 
      - name: 单元测试 + 覆盖率
        run: |
          pytest tests/unit/ \
            --cov=src \
            --cov-fail-under=80 \
            --cov-report=xml \
            --junitxml=unit-report.xml
 
      - name: 集成测试（Testcontainers）
        run: pytest tests/integration/ -m "integration"
 
      - name: SAST 安全扫描
        uses: github/codeql-action/analyze@v3
 
  # 第三层：合并级（目标 < 60 分钟）
  regression:
    name: "L3: 回归测试"
    needs: unit-integration
    if: github.event_name == 'pull_request'
    runs-on: ubuntu-latest
    timeout-minutes: 60
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 精准测试需要 diff
 
      - name: 精准回归测试
        run: |
          python scripts/precision_test_selector.py
          pytest $(cat precision-tests.txt) --html=report.html
 
      - name: E2E 关键路径（Playwright）
        run: |
          npx playwright test --grep "@critical"

# pytest BVT 用例标记示例
import pytest
 
@pytest.mark.smoke  # BVT 冒烟标记
class TestOrderBVT:
    """订单核心功能 BVT - 5 分钟内验证构建可用性"""
 
    def test_create_order(self, api_client):
        """创建订单 - 最核心的功能"""
        resp = api_client.post("/orders", json={"sku": "A001", "qty": 1})
        assert resp.status_code == 201
        assert resp.json()["id"] is not None
 
    def test_query_order(self, api_client, create_test_order):
        """查询订单 - 读路径验证"""
        order_id = create_test_order()
        resp = api_client.get(f"/orders/{order_id}")
        assert resp.status_code == 200
 
    def test_pay_order(self, api_client, create_test_order):
        """支付订单 - 核心交易链路"""
        order_id = create_test_order()
        resp = api_client.post(f"/orders/{order_id}/pay")
        assert resp.status_code == 200
        assert resp.json()["status"] == "PAID"

# pytest 并行执行配置（pytest.ini）
[pytest]
addopts = -n auto --dist=loadfile  # 按文件分配，避免 fixture 冲突
markers =
    smoke: BVT 冒烟测试（5分钟内）
    integration: 集成测试（需依赖服务）
    slow: 慢测试（>10s）
    flaky: 不稳定测试（不纳入 BVT）